Создание бронирования

Запрос позволяет создать бронирование по результату поиска.

Синтаксис запроса

POST https://b2b-api.go.yandex.ru/integration/integration/v2/avia/bookings/create

Заголовки запроса

Authorization: Bearer <OAuth-токен>
Процесс получения токена описан в разделе Начало работы.

X-YaTaxi-Selected-Corp-Client-Id — идентификатор клиента из личного кабинета. Обязателен, если по токену доступно несколько клиентов.

X-Idempotency-Token — токен идемпотентности. Содержит от 1 до 256 символов. Обязателен при создании бронирования.

Тело запроса

Данные передаются в формате JSON:

Поле	Описание	Формат	Обязательность
`search_result_id`	Идентификатор результата поиска.	Строка	Да
`users_info`	Информация о пассажирах. Минимальное значение: `1`.	Массив	Да
`extras_info`	Дополнительные услуги.	Массив	Нет
`travel`	Информация о поездке: новая поездка: `{ name: string }`; существующая поездка: `{ id: string }`.	Выбор одного варианта	Да
`customer_email`	Email заказчика.	Строка	Да
`customer_phone`	Телефон заказчика.	Строка	Да

Структура объекта users_info:

Поле	Описание	Формат	Обязательность
`user_id`	Идентификатор пользователя.	Строка	Да
`first_name`	Имя.	Строка	Да
`last_name`	Фамилия.	Строка	Да
`patronymic`	Отчество.	Строка	Нет
`citizenship`	Гражданство.	Строка	Да
`document_type`	Тип документа: `INTERNAL`, `FOREIGN`, `BIRTHDAY_NOTIFICATION`, `PASSPORTLOSSCERTIFICATE`, `MILITARYID`, `PASSPORT`, `DIPLOMATIC`, `FOREIGN_NATIONAL_PASSPORT`, `SEAMANSID`.	Строка	Да
`document_number`	Номер документа.	Строка	Да
`document_expire_date`	Дата истечения документа.	Строка в формате даты и времени	Да
`birth_date`	Дата рождения.	Строка в формате даты и времени	Да
`gender`	Пол: `MALE`, `FEMALE`.	Строка	Да
`email`	Email.	Строка	Да
`phone`	Телефон в формате `+[0-9]{1,16}`.	Строка	Да
`bonus_card_number`	Номер бонусной карты. Можно указать до 50 символов.	Строка	Нет

Структура объекта extras_info:

Поле	Описание	Формат	Обязательность
`search_extras_id`	Идентификатор услуги из поиска.	Строка	Да
`user_id`	Идентификатор пользователя.	Строка	Да
`quantity`	Количество. Минимальное значение: 1.	Число	Нет

В ответе могут содержаться следующие поля:

Поле	Описание	Формат	Обязательность
`flight_reservation_id`	Идентификатор бронирования.	Строка	Да